BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / pc_board / tvd124.zip / TCBVD124.DOC < prev next >

Wrap

Text File | 1992-08-10 | 68KB | 1,513 lines

The Verify Door v1.24 August 2, 1992 Callback Verification Door Copyright (c) 1992 by Jim Lockhart Chapter Table of Contents 1.0 ......... Program Description 2.0 ......... System Requirements 2.1 ..... Modem Compatibility 2.2 ..... Setting Up Your HST Modem 2.3 ..... USR HST 14.4 Suggested Settings 3.0 ......... Error Handling 4.0 ......... Demo License 5.0 ......... Registration License 6.0 ......... Disclaimer 7.0 ......... Beta Testing 8.0 ......... System File Names 9.0 ......... System Files and Formats 9.1 ..... TCBV.CNF Short Line by Line Description 9.2 ..... TCBV.CNF Line by Line Description and Usage 9.3 ..... TCBVNAL 9.4 ..... TCBVVER 9.5 ..... TCBVTIME 9.5.1 TCBVTIME Parameters 9.6 ..... TCBVAL 9.6.1 Dialing String Format 9.7 ..... TCBVAREA 9.8 ..... The LOG file 10.0 ......... The Verify Door Operation 10.1 ..... Status Bar Description 10.2 ..... Single Node Operation 10.3 ..... Multi-Node Operation 10.4 ..... Exit Codes (DOS Errorlevel) 11.0 ..... Registering The Verify Door 12.0 ..... Technical Support 13.0 ..... Registration Form 1.0 PROGRAM DESCRIPTION ─────────────────── The Verify Door (TVD) is a door program designed specifically to run with PCBoard v14.x and 14.5a. This program automatically handles verification of your new users phone number by establishing callback verification and supports multi-lingual operation. The user enters the door and enters his phone number. The user's phone number is checked against a trashcan file then against previously verified phone numbers and finally is checked for what time of day it may be dialed. The door then drops carrier on the user. After a sysop configurable amount of time, TVD will disable your modem's error correction if the user has called in a non-error-correcting mode, then it will dial the number that the user entered. If no modem is found at the user end the results are stored and TVD recycles to PCBoard. If carrier is detected the user is prompted to enter his password. If the password entered matches the password from that users record in the user file the users' security level is upgraded along with other optional user settings as defined by the Sysop. The user gets two tries at entering his password. After the second wrong password entry (or no password was entered) the user is disconnected and TVD recycles to PCBoard. TVD will attempt to dial the maximum number of times you have it configured for, however, only two CONNECTions are allowed each time the door is run. This helps limits hackers from tying up your phone lines and should also help your long distance phone bill. The sysop can locally ABORT TVD by hitting the SHIFT+F1 keys at any any time. Hitting SHIFT+F1 will abort, then write a SYSOP ABORT message to the log and return to PCBoard. This version contains a small amount of sophisticated self-test code to ensure TCBVDxxx.EXE executable file integrity. If the executable file has been altered in ANY way, such as from a virus, hacking, system drive problems, etc, TVD will let you know by issuing an 'Error in file' warning, will stop running, and at that point your batch file should return to PCBoard. If TVD runs and does NOT display a corrupted file message, then you can be assured that you have received a virus-free and unaltered copy of TVD. 2.0 SYSTEM REQUIREMENTS ─────────────────── *80286/386/486 required (XT version available) *PC or MS DOS v3.00 or higher required *ANSI.SYS, DVANSI or equiv. should be loaded TVD is multitasking compatible (at least with DesqView v2.3 and DesqView/X) and is also known to function correctly in the Novell and 3Comm environments. TVD will relinquish time slices during timer countdowns and during user/keyboard input if desqview is detected. TVD is compatible with COM1-8, IRQ 1-7 and up to 115,200 baud. TVD will read your PCBOARD.DAT file and automatically retrieve the correct communications port attributes from it. TVD is written in 80286/386 specific code and will not run on an 8088 (XT) machine. If you have been running TVD on an XT, a verison written to run on the XT is available from Page Three BBS and is downloadable as TVD124XT.ZIP. TVD is specifically written to run as a PCBoard v14.x door and should not be expected to operate with other bulletin board software, though it is know to run with RBBS. It is compatible with single or multi-node PCBoard operations, including the new PCBoard v14.5a code (see *note below.) >>> TVD must have access to the following PCBoard system files on each node running TVD: PCBOARD.SYS PCBOARD.DAT USERS TVD can be configured to access either your caller log(s) or a separate log file(s). * NOTE: This door will NOT operate on your system if you are using the ENCRYPT program on your USERS file! If you are concerned about the security of your users file to the point where you have run the encryption program, then this door is not for you. 2.1 MODEM COMPATIBILITY ─────────────────── TVD has been found to function correctly on the following brands of modems: Hayes, USR, Everex, Cardinal, Telebit, Ven-Tel and Hisland modems. It should work OK on most 'Hayes compatible' modems with or without MNP error correction. The Verify Door will wait for a line of data to come in from your modem that contains a recognizable result code string similar to that of the HAYES standard. The following valid result codes are parsed by TVD. If any of the following strings are returned as result codes from your modem they are handled as described. "NO ANSWER"─────> call retried "BUSY" ─────────> call retried "NO DIAL TONE" ─> call retried "NO DIALTONE" ──> call retried "NO CARRIER"────> call retried "CONNECT" ──────> call connected at any baud rate "RING " ────────> call retried ─ nasty mode turns on if enabled "VOICE" ────────> call retried If no response is received from your modem within the timeout period specified in the TVD config file, TVD will make an entry to the specified log file and will return to PCBoard. NOTE TO SYSOPS WITH MNP-EQUIPPED MODEMS: TVD will now optionally disable your modems MNP feature if your modem is equipped with it and you enter the command that your modem uses to do so in the config file. This feature will eliminate the garbage that a user sees when your MNP modem calls out and connects to the users non-mnp modem. NOTE TO USR HST USERS: If you have recently upgraded your HST to v.42 bis, be sure to check and reset S38=0 if necessary. There is a known bug in some releases of the new 'supervisor' chip that sets your S38 register to 255 when the chip is first installed! TVD will not function properly if this register is set to more than 2 or 3 seconds, so set it to 0 just to be on the safe side. The command to disable the HST's MNP is &M0 and should be placed in the correct location in the TVD config file. You should also insert the &M4 command in the modem init string found in PCBSETUP. NOTE TO TELEBIT MODEM USERS: Check and reset S38=0 if needed. TVD won't like it one little bit (no pun intended) if this setting is more than 2 or 3 seconds, so I suggest setting it to 0. 2.2 SETTING UP YOUR HST MODEM: This door has been written to be compatible with all parameters set by PCBMODEM. One configuration parameter that you should make sure of - dialtone checking should be ON! There are a few modems that when connected to certain telephone company lines do not properly detect the presence of a dial tone. If you have had a few of your friends or users call and the code just doesn't seem to want to call them back, then set your modems X parameter to X3 instead of X4. The X3 setting will disable your modem from sending the NO DIALTONE result code back to the door code and the door should dial out whether you modem thinks there's a dial tone or not. This should not present any security problem because when the door dials out, it is looking for the other modem to send carrier. I suggest using the X7 setting if you are using an HST modem. If you have problems with modem compatibility please report them to Jim Lockhart at Page Three BBS, (407) 327─8421 (Node 1) or call node 2 at (407) 327-4524. (PC-Pursuit users use FLORL) Include a ZIPped copy of your configuration (TCBV*.*, and error.log files), a description of the problem and what modem you are running including any error codes given by the code when the error(s) occurred. 2.3 USRobotics Courier 14400 HST Suggested Settings... ────────────────────────────────────────────────── B1 C1 E0 F1 M0 Q0 V1 X7 BAUD=38400 PARITY=N WORDLEN=8 DIAL=HUNT ON HOOK TIMER &A3 &B1 &C1 &D2 &G0 &H1 &I0 &J0 &K0 &L0 &M4 &N0 &P0 &R2 &S0 &X0 &Y1 S00=000 S01=000 S02=255 S03=013 S04=010 S05=008 S06=002 S07=060 S08=002 S09=006 S10=010 S11=050 S12=050 S13=000 S14=001 S15=008 S16=000 S17=000 S18=000 S19=003 S20=000 S21=010 S22=017 S23=019 S24=150 S25=000 S26=000 S27=000 S28=008 S33=000 S38=000 3.0 ERROR HANDLING & CARRIER LOSS ───────────────────────────── Great pains have been taken to make The Verify Door as user-foolproof and hacker proof as possible. In the event of some kind of error, an entry is made in the ERROR.LOG file, then the door will disconnect anyone who is still connected and recycle to PCBoard. Hopefully no errors will occur, but I don't always write perfect programs either! If carrier is lost for any reason other than the door dropping carrier during a callback, the door will detect loss of carrier and recycle to PCBoard. TVD will also recycle to PCBoard if your modem doesn't respond to TVD commands or gets no answer from a dialed phone number within the amount of time specified in the modem response/no answer timeout setting. Caution! TVD is not SYSOP proof. You must take the time and care to configure TVD correctly or you will get unexpected errors! I suggest using the installation/setup program that comes with this version or you can print out the docs and carefully do it yourself. If you get an error or you cannot get the door to operate on your system and you cannot figure out what the problem is, feel free to call Page Three BBS (numbers below) and leave a message or comment to SYSOP or Jim Lockhart along with the error code issued. Updates to TVD are always posted in the upload directory on Page Three BBS. You can always call and immediately get the latest release of The Verify Door unhacked and virus-free any time without having to go through Page Three's verify door. Just log in and download it.... ANOTHER NOTE: Please remember that, in the event you really mess up the configuration of this door, your USERS file will come to no harm! This door is written so that it MUST be running EXACTLY right in terms of file access before it will access the USERS file. 4.0 STANDARD "DEMO" LICENSE ─────────────────────── The Verify Door is a 'Shareware' program. I encourage everyone to upload and share the code. Several limitations must be implied however: 1) Under no circumstance shall the code be modified or distributed in any other form than in that which it was originally supplied (the original is ZIPped, but it may be distributed in other archive formats as long as the de-compressed form of the program remains the same). 2) The Verify Door may NOT be redistributed in any manner OTHER THAN by electronic file transfer except in cases approved by the author. Receiving money for The Verify Door program itself is absolutely forbidden to anyone but the author, except for telecommunications or service charges. No fee of more than $5.00 shall be collected in such an instance. 3) The Verify Door may be run for an adequate amount of time to allow a full testing of the software. If, after running the code for 30 days, you do not purchase the registration license (cost is $20.00 US) then this license is terminated and you must remove all working copies of The Verify Door from your system. 4) UNMODIFIED copies of The Verify Door and its files may be distributed to ANY bulletin board system anywhere. 5) The demo version may not be "hacked" or modified in ANY manner, including but not limited to modifications leading to the enabling of the extended features outlined in this document which are labeled as being available only to those systems running The Verify Door with an authorized Verify Door Registration Number. Under no circumstance may anyone use a registration number in use by another individual. The Standard "Demo" License as outlined above may be withdrawn by the author of The Verify Door at any time without exception. 5.0 REGISTRATION LICENSE ──────────────────── Users that decide to purchase a Verify Door Registration Number receive several benefits as outlined below. 1) Once purchased, the registration license is non-refundable. All future releases of The Verify Door written by Jim Lockhart, its present author, will be compatible with any registration license and The Verify Door Registration Number sold to the individual purchasing the license. 2) The registration license authorizes use of all features marked in this documentation as "Registered Version Only." 3) The registration license entitles the holder to free access to Page Three BBS, the location of support maintained by the author, as long as the holder of the license adheres to the policies of said BBS. Note that Jim Lockhart may not be held liable in any manner or for any reason for not supplying said access. 4) The registration license is non-transferable. The name of the bulletin board registered may be changed if evidence is given that such a change will take place. It is expressly forbidden to use the old registration number once a new one is issued. 6.0 DISCLAIMER ────────── The author of this software, Jim Lockhart, is not liable for any lost funds, equipment, or data due to the use of this program except under circumstances where it can be proven that code was intentionally written by Jim Lockhart to do so. 7.0 BETA TESTING ──────────── Each version of The Verify Door is beta tested on the authors system and several close by, along with other bulletin boards choosing to beta test new code throughout North America. I try to make sure that when you get a copy of the released version that there is nothing in the door that could possibly go wrong. Please realize that, though every effort is made, some errors may slip through. If an error occurs and you can't find the problem on your own then please notify me as soon as possible, despite all the legal stuff. I'll do the best I can to take care of any problem with successfully running The Verify Door that you might have. 8.0 SYSTEM FILE NAMES ───────────────── ERROR.LOG > This file will be created in the directory in which TCBVDxxx resides in the event of an error. This is the file you want to look at when reporting errors that you cannot resolve on your own. The following files must exist in your Verify Door working directory: TCBVDxxx.EXE > main executable door code WELCOME > initial user instructions (text) WELCOMEG > initial user instructions (ansi) WELCOME.SPA > Spanish language user instructions (text) WELCOMEG.SPA > Spanish language user instructions (ansi) TCBVTEXT > file containing most text messages that appear TCBVTEXT.SPA > Spanish version of TCBVTEXT TCBVAL > allowed numbers file listing (described in full detail later in this file) TCBVAREA > area code file of area codes local to you TCBVVER > verified numbers/names/dates file (described later) TCBVTIME > time format file (described later) TCBVNAL > specifically disallowed numbers (described later) SETUPxx.EXE > setup program Note: TVD supports multi-lingual operation in the same manner that PCBoard does. If files are found in the TVD directory that have the same foreign language filename extension that the user is using, TVD will use them. If not found, TVD will default to using the english language prompts. 9.0 SYSTEM FILES AND FORMATS ──────────────────────── TCBV.CNF (configuration file overview) The TCBV.CNF file is the main configuration file central to operation of The Verify Door. It includes drive/path/filename information on your PCBoard and TVD system files, TVD registration information and various other feature enable/disable settings. For a complete description of each entry see the following sections 9.1 and 9.2. All entries in your TCBV.CNF file must be left justified. Please run the SETUPxx.EXE program first if this is the initial installation of TVD on your system to ensure that the correct path names get entered into the config file. 9.1 The TCBV.CNF file: Line Description Example ──── ─────────── ─────── 1 Maximum redial attempts if Local 5 2 Maximum redial attempts if Long Distance 2 3 Enable long distance dialing? (Enable = y Disable = n) y 4 Location and name of PCBOARD.SYS file C:\PCB\PCBOARD.SYS 5 Location and name of PCBOARD.DAT file C:\PCB\PCBOARD.DAT 6 Name of your BBS (Also see line 8) Page Three BBS 7 Registration number (0 = demo copy) 0 8 Use system name from PCBOARD.DAT ? (Y=use system name from PCBOARD.DAT, N=use system name from config file entry) Y 9 Location and name of log file. May be the PCBoard CALLER log or a separate text type log. C:\DOOR\LOG.TXT 10 Security level of 'new user' 1 11 Security level to increase user to after verifying 62 12 Amount of time to add to user on line time 5 13 Enable local screen status bar? (Y = enable, N = disable) y 14 Check trashcan and previously verified numbers before dialing? (Y or N) (Registered version only) y 15 Running multi-node or in a network? (Y or N) y 16 Your time zone. Any time zone designation up to 8 characters long may be used. Examples: Eastern, Central, Mountain, Pacific, EDT, EST, CDT, CST, etc. Eastern 17 Enable Auto-ANSI color graphics ? (enable = Y, disable = N) y 18 ALWAYS disconnect user at the completion of verification ? (enable=y, disable=n) n 19 New expired security for user (disable = N) (enable = 1, 2 or 3-digit entry) n 20 Sysop maintained comment field (enable = Y, disable = N) y 21 Configurable upload/download stats line #1 n (Active in Registered versions only) 22 Configurable upload/download stats line #2 n (Active in Registered version only) 23 Configurable upload/download stats line #3 n (Active in Registered version only) 24 Configurable upload/download stats line #4 n (Active in Registered versions only) 25 Delay time before dialing out (seconds in addition to built in 9 second built-in delay) 0 26 'Nasty' dial out enabled ? (n=ask for name only) y 27 Modem response/no answer timeout in seconds 60 28 Modem command to disable error correction NONE (see below) 29 Registration date adjust n 9.2 TCBV.CNF (configuration file - line by line description) ──────────────────────────────────────────────────────── 1 Maximum redial attempts if caller is Local ────────────────────────────────────────── Options: Recommended setting is 5. Valid entries: 2 through 9 This entry sets the maximum number of times TVD will attempt to dial out when the last attempt got something other than CONNECT* from the modem and the user is calling from a local telephone number. *There is non-configurable maximum of two CONNECTions allowed each time TVD is run. 2 Maximum redial attempts if caller is Long Distance ────────────────────────────────────────────────── Options: Recommended setting is 2. Valid entries: 2 through 9 This entry sets the maximum number of times TVD will attempt to dial out when the last attempt got something other than CONNECT* from the modem and the user is calling from a long distance telephone number. *There is a non-configurable maximum of two CONNECTions allowed each time TVD is run. 3 Enable long distance dialing? ───────────────────────────── Options: y - allow L.D. dialing in accordance with TCBVAL and TCBVTIME n - NEVER dial long distance (override other settings) This entry tells The Verify Door whether or not to EVER call long distance to verify a user. If you set this option to N, TVD will NEVER call long distance and will over-ride all other long distance calling options you may have set in the TCBVAL file. Setting this option to Y tells TVD to dial long distance in accordance with parameters set in the TCBVAL and TCBVTIME files. 4 PCBOARD.SYS file name & location ──────────────────────────────── Entry: Complete drive\path\filename of pcboard.sys This entry tells The Verify Door the location and name of your "PCBOARD.SYS" file. 5 PCBOARD.DAT file name & location ──────────────────────────────── Entry: Complete drive\path\filename of pcboard.dat This entry tells The Verify Door the location and name of your "PCBOARD.DAT" file. 6 System Name ─────────── Place the name of you bbs on this line. If the entry on line 8 is N, then TVD will use the system name as you have entered it on line 6. If line 8 is set to Y, TVD will use the system name it reads from PCBOARD.DAT and will ignore the entry on this line. 7 Registration number ─────────────────── Place a 0 on this line if you are running the demo copy of The Verify Door. If you have registered your code place the registration number you were supplied with on this line to enable the additional features found in the registered software. 8 Use the system name as read from PCBOARD.DAT? ───────────────────────────────────────────── Options: Y or N When this option is set to Y, TVD will read your BBS name from PCBOARD.DAT and will ignore any entry made on line 6 of the config file. When set to N, TVD will read the system name you gave on line 6 and will ignore the system name contained in PCBOARD.DAT. 9 Log file ──────── This line contains the location and name of your TVD log. The Verify Door will append to the PCBoard caller file if specified. However, it is recommended that you create a separate log file in the directory in which your door code resides. 10 Security level of new user ────────────────────────── This is the security level of a new user. If a user enters the door and his/her security level does not match this number the user will be returned to the PCBoard system. 11 Security level to raise user to after verification ────────────────────────────────────────────────── This is the security level you wish to give the user after he/she has been successfully verified. 12 Number of minutes to add to time limit after verifying ────────────────────────────────────────────────────── This is the number of minutes you wish to add to a users time limit after he/she has been verified. Since PCBoard 14.5 will automatically adjust the users time after The Verify Door upgrades his/her security level, it is not necessary to put more than 5 minutes or so in this option. This feature was included so that the sysop can compensate the user for average time spent in The Verify Door. 13 Enable local screen status bar ? ──────────────────────────────── Options: Y or N The Verify Door will display a status bar at the bottom of the local screen if this flag is set to Y. This status bar is meant to look similar to but not identical with the one PCBoard displays. Set this flag to N if you do not wish to have the status bar appear. 14 Check trashcan and previously verified numbers before dialing? ─────────────────────────────────────────────────────────────── Options: Y or N This option is active only on the registered version and is ignored on the demo copy. If a user is about to be verified and this flag is set to 'y' (and the copy you are running is registered) his/her phone number will be checked against all entries in the TCBVVER and TCBVNAL files and will not be dialed if an entry with the same phone number in either file was found. What will the demo version do? The demo version of TVD will check only the first three entries in the trashcan file TCBVNAL regardless of this setting. The verified users file TCBVVER WILL be written to upon successful user verification but will NOT be checked for entries with the same phone number when another new user who is about to be verified uses the door. Registering TVD will fully enable the checking features outlined above 15 Running multi-node or in a network environment? ─────────────────────────────────────────────── Options: Y or N With this flag set to yes, you should have SHARE loaded. >>>Set this flag to N if you are running one node of PCBoard.<<< >>>This flag need NOT be set to Y if you are multitasking and running only 1 node of PCBoard<<<< Setting this flag to Y indicates to the door that you are running more than one node of PCBoard and that files such as the USERS file, TCBVVER, etc., must be shared by both copies of PCBoard and both copies of The Verify Door. 16 Your Time Zone. ─────────────── You should enter your time zone here. Any entry up to 8 characters is accepted. This setting is used when a user calls long distance and tries to get verified outside of the time range(s) you have set for your system to call long distance. The user will get a three line prompt telling him what the next 'time slot' for calling him long distance is. The user is displayed the times along with whatever you put on this line of the config file. Some examples: Eastern, Central, Pacific, Mountain, EST, EDT, CDT, CST, MDT, MST, PDT, PST, etc. 17 Enable Auto-ANSI Color graphics ? ───────────────────────────────── Options: Y or N With this flag set to "Y" The Verify Door will automatically turn on ANSI color if the user has the color mode turned on in PCBoard. Set this flag to "N" if you never want color used in the door no matter what the users settings are in PCBoard. Note: Color graphics will not appear on the local screen if the network/multitasking flag is set to Y. 18 Always disconnect user at end of verification? ────────────────────────────────────────────── Options: Y, N If you would like to disconnect the user after a successful verify, then set this flag to Y. The door will then disconnect the user regardless of whether he is calling long distance or local. Set this flag to N if you wish only to disconnect long distance users after verification. Users will be automatically disconnected under the following conditions: Keyboard timeout. Pressing enter too many times. Pressing enter when the door asks for password. User enters wrong password twice. 19 New expired security to give user ───────────────────────────────── Options: 1, 2 or 3 digit number, or the letter N. Enter the expired security level you wish the verified user to have and it will be written to the users record in the user file when the user is successfully verified. You can also put N as an entry here if you do not want any change in the users expired security level. 20 Sysop maintained comment field enabled? ─────────────────────────────────────── Options: Y or N This option when set to Y allows The Verify Door to write the verified user phone number to the sysop-maintained comment line in that users record in the user file. (Comment line #2) Also when this option is set to Y and the user was unsucessful at getting verified, TVD will give some idea of what happened on comment line #2. 21 Configurable upload/download statistics line #1 ─────────────────────────────────────────────── Once your new user is verified, you may wish to modify his/her upload/download statistics especially if you are running PCBoard with some sort of ratio tracking. Use lines 21, 22, 23 and 24 in the config file if you wish to adjust the users record for the following statistics: 1st 2 letters Statistic type: of the entry: Valid range ────────────────────────── ───────────── ────────────── Number of files uploaded fu 0 to 32767 Number of files downloaded fd 0 to 32767 Number of bytes uploaded bu 0 to 999999999 Number of bytes downloaded bd 0 to 999999999 Make only one entry per line. These four lines may be configured in any order you like (ie, fuxxx does not have to be on line 21). Entries should be in the format: ccn where the first two characters will be one of the following: fu, fd, bu or bd and where n is any number within the valid range listed above. NOTE: If you do not wish to change ANY of the users upload/download statistics, enter an 'n' on each of the four lines. If you wish to change only one, two, or three statistics, make your entries as necessary, then make an 'n' entry on each of the four lines not used. For example, lets say you want to give the user credit for one file uploaded. The entry would read: fu1 Or, lets say you want to give the user an upload byte credit of 123456 bytes, the entry would read: bu123456 More examples: entry: what it does: bu1024 enter 1024 bytes upload credit to the user record fu100 enter 100 files upload credit fd10 enter 10 files download debit bd100000 enter 100000 bytes download debit Lets say you wanted only to enter an upload file credit of, say, 1 file to the users record, but don't want to change anything else. Lines 21-24 might look something like this: fu1 n n n n fu1 n n n OR n OR fu1 OR EVEN n n n n fu1 Any one of those four ways of writing lines 21-24 will get the job done. (Yes, this program is so user friendly, you can mix and match these four lines as you see fit!) (Registered version only. Lines 21, 22, 23 and 24 are ignored in the demo version) 22 Valid entries described above, see line 21 23 Valid entries described above, see line 21 24 Valid entries described above, see line 21 25 Delay time before dialing out in seconds ──────────────────────────────────────── This setting allows the TVD to compensate for modems that are slow to disconnect from the phone line and also for slow to respond phone lines. The Verify Door has a built in 9 second delay, so whatever you put on this line of the config file is in addition to the 9 second built in delay. Keep in mind that even though your modem may show that the phone is back on hook that it takes up to several seconds for your users modem to give up the phone line and issue your user a NO CARRIER message. 26 'Nasty' dial out? ───────────────── Options: Y or N This setting allows you to determine how TVD dials out under conditions that are normally found only on very busy bulletin boards. When set to N, The Verify Door will dial out normally and in pretty much the same manner as any other communications program. When set to Y, however, The Verify Door will dial out in the 'Nasty' mode where if it detects an incoming call while it's trying to dial out, it will pick up your modems phone line, wait 3 seconds while doing nothing, hang up, wait 1 second and then attempt to dial out to the new user. Use this feature only if you notice a lot of 'RING' or 'NO DIALTONE' messages in your doors log file and only if you are certain The Verify Door is working correctly. This feature is also know as a "forced off-hook" option. 27 Modem no-response/no answer timeout ─────────────────────────────────── Valid entries are 30 to 300 (seconds) Suggested setting: 60 seconds This setting allows you to determine how TVD will react if your modem does not return a recognizable response code to TVD commands within the amount of time you set. It also doubles as a NO ANSWER timeout in case your modem can't be or isn't configured for it. TVD makes a log entry of NO MODEM RESPONSE or NO ANSWER and returns to PCBoard upon timing out in either case. 28 Command to issue to your modem to disable error correction. ─────────────────────────────────────────────────────────── Valid entries: Just about anything up to 80 characters long. : An entry of NONE will disable this feature. NOTE: Enter NONE if your modem does not support error correction or if you wish to disable this feature. This entry should include ONLY the command that your modem requires to disable error control (MNP) if your modem has this feature. * You should also insert a command into your modem's init string by * * running pcbsetup to re-enable error correction on your modem * * when PCBoard resets. * TVD will automatically insert the string you enter here into your dialing string after the AT command to disable error control on your modem when it is calling a user that has called with a non-error correcting modem. Example: The USR HST modem uses the command &M0 to disable error control. Although this entry will be ignored if your modem does not support error correction, you should enter NONE on this line anyway. 29 User registration date adjust ───────────────────────────── Options: N, 0 or a positive number less than 32767 (Registered version only. Line 29 must be present in the config file but is ignored in the unregstered version) This setting allows the sysop to tell TVD what (or what not) to do with the user registration expiration date in the user file. Setting this option to N or n tells TVD to do nothing with the user expiration date. Setting this option to 0 tells TVD to set the user expiration date to all zeros upon successful verification. Setting this option to a positive number specifies the number of days TVD will add to the date of successful verification. TVD will then update the user expiration date with the calculated date. 9.3 TCBVNAL FILE ──────────── The phone number trashcan file (TCBVNAL) is used primarily as a place to store any SPECIFIC telephone numbers that you do not want The Verify Door to dial (such as the numbers of other local BBS's, the police/fire/ambulance numbers, information, etc.) This file is also used to store telephone numbers that you do not want dialed. To do this simply place the complete phone number in the file, in the following format: aaa-ppp-ssss Example: 407-675-3244 │ │ │ 900-???-???? │ │ suffix Note: Wildcard (as shown) may be │ prefix used disallow calling of groups area code of numbers. The demo version reads and acts upon only the first three entries in this file. The registered version reads and acts upon ALL entries in this file. >>>> BE ADVISED! BE SURE you have the following two entries in your TCBVNAL file: 911-???-???? ???-911-???? The above entries will prevent the 911 squad from showing up at your front door step in the middle of the night should some wise-guy user decide to enter this as a number to verify! If you are running the DEMO version, I suggest making sure that the above two entries are the first two entries in TCBVNAL because the DEMO version reads only the first THREE lines in this file! 9.4 TCBVVER FILE ──────────── Every phone number successfully verified by The Verify Door is placed in this file. The Verify Door adds to this file to store the name of the user and the time/date the number was verified. For example: "407-555-1212","JIM LOCKHART","06-25-1990" │ │ │ phone number last, first date of verify NOTE: The demo version of The Verify Door will append entries to the TCBVVER file but will not check for previously verified phone numbers. Once TVD is registered, it will read all existing entries in the TCBVVER file and will eliminate the problem of one user calling your system using several different log-in names because the registered version of TVD will not call an already verified number back. (This was the main purpose for writing TVD in the first place.) 9.5 TCBVTIME FILE ───────────── The TCBVTIME file is used in conjunction with the TCBVAL file to determine what time of day a number or group of numbers may be dialed. This feature will help cut down phone costs. The TCBVTIME file is a text file that consists of three entries, each separated by a comma. Shown below is a diagram of an entry in TCBVTIME: FORMAT #1 A, 17:01, 07:55 (see 9.5.1 below for complete ┬ ──┬── ──┬── descriptions of each entry) │ │ │ │ │ │ │ │ stop time │ start time Time period letter that appears in TCBVAL FORMAT #2 A, 17:01, 07:55,00:00,23:59 (see 9.5.1 below for complete ┬ ──┬── ──┬── ──┬── ──┬── descriptions of each entry) │ │ │ │ weekend stop time │ │ │ weekend start time │ │ stop time │ start time Time period letter that appears in TCBVAL 9.5.1 TCBVTIME PARAMETERS ─────────────────── 'start time' = This is the time to start allowing entries with this format letter to be dialed. Valid entries are 00:00 through 23:59 'stop time' = This is the time to stop allowing entries with this format letter from being dialed. Valid entries are 00:00 thru 23:59 'weekend start time' = This optional entry is the time to start allowing entries with this format letter to be dialed on the weekend (Saturday and Sunday) Valid entries are 00:00 through 23:59 'weekend stop time' = This optional entry is the time to stop allowing entries with this format letter from being dialed on the weekend (Saturday and Sunday) Valid entries are 00:00 through 23:59 The Sysop may define up to 26 different time periods, one for each letter of the alphabet. After setting a time period up in the TCBVTIME file, include the letter you configured it for in each entry of TCBVAL you wish to use the TCBVTIME entry defined. If a user calls outside of a valid start/stop time, TVD will display the next available valid time period for calling him back. >>> Please note: 24:00 is NOT a valid time entry. 9.6 TCBVAL FILE ─────────── The TCBVAL file is used to tell The Verify Door what phone numbers it may call and how to go about doing so. The Sysop defines what number(s) it can dial (exchange, prefix, suffix, and what the user has answered to the long distance question), when they can be dialed (used in conjunction with the TCBVTIME file), and what to send to the modem when dialing the number that matches that TCBVAL entry. The TCBVAL file consists of one line for each phone number criteria you wish to give it. Each line entry in this file consists of four fields. Shown below is the general TCBVAL entry format: 407-???-????,N,A,"ATDT%02%003" ┌── ┌── ┌─── ┌ ┌ ┌─────────── │ │ │ │ │ │ │ │ │ │ │ dialing string format to send (Note 4 and 9.6.1) │ │ │ │ │ │ │ │ │ time period to allow calling (Note 3 and 9.5) │ │ │ │ │ │ │ long distance flag (compared to users answer) (Note 2) │ │ │ │ │ suffix (? marks used as a wildcard character) (Note 1) │ │ │ prefix (Note 1) │ area code (Note 1) Notes: 1) The phone number field. This field may consist of digits or the wildcard character "?" and is used to allow you to specify certain area codes and/or telephone exchanges that you want to have TVD dial. 2) TVD looks for a Y or N in this field. This allows you to configure the door so that it knows the format you want to use for dialing a local number as opposed to a long distance number. 3) The third field is the letter associated with the time period to allow TVD to dial. The letters and their associated time periods are listed in the TCBVTIME file. 4) The dialing string format field tells TVD how to issue a dialing string for a user phone number. If the letters DP or dp (for pulse dialing) are detected in the dialing string, TVD will wait 10 seconds after issuing a dialing command to your modem before beginning the scan for result codes. The Verify Door compares the number that the user entered with each entry in TCBVAL until it finds an entry that matches. The more specific entries should be placed at or near the beginning of the file (the ones with the fewest wildcards). The Verify Door will compare the prefix, suffix, and area code and the answer to the long distance question. If the number and answer to the long distance question matches with an entry in TCBVAL, that line will be used for dialing the users number. If not, The Verify Door will go to the next line and keep going until it reaches a matching entry or the end of the file. If no match is made, The Verify Door notifies the user that the number is not available for callback. A NOTE ABOUT LONG DISTANCE DIALING If you have configured TVD to disable long distance dialing and the user has answered Y to the long distance question, he/she will see a message that long distance dialing has been disabled. TVD will then return to PCBoard without dialing out. See the explanation for line 3 of the config file for more information on disabling long distance dialing. 9.6.1 Dialing string Format ───────────────────── The dialing string format tells The Verify Door how to dial the telephone number (e.g. ATDT%02%003 or ATDT1%01%02%003 etc.) The table below shows each dialing string format and how it affects dialing. Key: [%01] = area code user entered [%02] = prefix user entered [%003] = suffix user entered ATDT%02%003 ── Dials last 7 digits only using Tone dialing ATDT1%02%003 ── Dials '1' and last 7 digits using Tone dialing ATDT1%01%02%003 ── Dials '1' +area + 7 digits using Tone dialing ATDP%02%003 ── Same as above using pulse/rotary dialing* *Note: If you don't have touch tone service on your phone line(s) then change the ATDT entries to ATDP to tell the modem to pulse dial as shown in the example. Sample TCBVAL file ────────────────── 407-???-????,N,A,"ATDT%02%003" 407-???-????,Y,B,"ATDT1%02%003" ???-???-????,Y,C,"ATDT1%01%02%003" The first line in the sample file allows local calls (user answered N to the long distance question) and the number was within the 407 area code) to be dialed. For example, if the user entered 407-555-1212 and N to each prompt in The Verify Door, The Verify Door would send the following string to the modem: ATDT5551212 and would allow the user to remain connected afterwards, returning the user to the PCBoard. (You can configure TVD to ALWAYS hang up at end of verify. See entry #18 of TCBV.CNF file) The second line in the above file would allow Long distance calls within the 407 area code (user answered Y to the long distance question and entered 407 as his area code), the number would be dialed as: ATDT15551212 and would be disconnected after the user entered his/her password , provided the call was within the time period specified by B in the TCBVTIME file. (Long distance calls are ALWAYS disconnected) The third entry in the above file allows Long distance calls outside of the 407 area code (user answered Y to the long distance question and put in an area code other than 407) provided the call was within the time period specified by C in the TCBVTIME file. Say the user put in 201, 555, 1212, N , for the area code, prefix, suffix and long distance questions respectively. The Verify Door would send ATDT12015551212 to your modem and would disconnect after the user entered his/her password. If you intend send setup commands to your modem within the TVD dialing string you might first verify that the dialing string you intend to use works in your favorite communications program before putting it into a TVD dialing string. 9.7 TCBVAREA ──────── The TCBVAREA file is used to tell The Verify Door what area code or area codes are in the local calling area for your BBS. This file is used to prevent callers who have previously been verified and are calling local from entering a false area code and their real prefix and suffix and then getting verified. Here's how it works: (Registered version only) If a caller calls from within your local area code(s) listed in TCBVAREA and tells TVD it is a local call, TVD will temporarily replace the area code that the user entered with the area code(s) of your local dialing area and THEN will check the TCBVVER file for a duplicate number. Although this file must be in place on your system, TVD will check the TCBVAREA and TCBVVER files for false area codes and already verified numbers only when registered. 9.8 LOG FILE ──────── The log file used by The Verify Door can be configured to either append entries to your PCBoard caller log or to a log text file of your choice. The path and filename for the log file is configured in the config file for The Verify Door, TCBV.CNF is the default config file name. Log file entries include the following types of entries: BUSY NO CARRIER VOICE RING DETECTED NO DIAL TONE NO DIALTONE NO ANSWER CONNECT No response from modem Wrong Password: [password entered] Bad Number not dialed User name [date time] Carrier Lost ... Not at new user level Bad number not dialed Aborted Illegal dial time for [phone number] Maximum redials reached [phone number] already verified to [user name] Number dialed: [phone number] [(Long Distance)] [(Local)] User pressed only ENTER when prompted for password Improper or no user response to prompt Successful Verify Caller logged of by TVD Local call returned to PCBoard 10.0 The Verify Door OPERATION ───────────────────────── Invocation of The Verify Door (usually done by the PCBoard running a batch file) is pretty straightforward. Below are sample batch files for invoking The Verify Door. A sample batch has been included in the archive for your convenience. No other auxiliary programs, or drivers are required as TCBVDxxx.EXE is actually a stand-alone communications program specifically written to interface with PCBoard. The sysop can abort TVD by pressing SHIFT+F1 at just about any time during TVD execution. Note: TVD will not work with fossil drivers. Since PCBoard does not require the use of a fossil driver, it is assumed that none are in use. ******************************************************************** 10.1 Status bar description ────────────────────── If you have it enabled, a two line status bar will be displayed at the bottom of your screen when TVD is running. It wil display the users name, time, date, security level, modem activity/results, and several countdown/delay timers. Here's what the status bar display means: User Dial Baud MNP User Name Future Use Attempt # ┌────┐┌┐ ┌───────────┐ ┌───────────────────┐ ┌───────────┐ ┌─────────────────────────────────────────────────────────────────────────────┐ │The Verify Door (2400E) BILL JONES Attempt # 1 │ │02-02-1992 12:54:57 T/O= 1 Sec= 1 Status: Polling modem Wait: 59│ └─────────────────────────────────────────────────────────────────────────────┘ └────────┘ └──────┘ └─────┘ └─────┘ └────────────────────┘ └──────┘ Date Time # Times Security Modem result codes and Timers On Level program activity (seconds) ******************************************************************** 10.2 SINGLE NODE OPERATION: cd d:\door } You should put all TVD associated files in a separate directory tcbvd124 d:\door\tcbv.cnf } Command line to invoke the door using TCBV.CNF as the configuration file and runs The Verify Door. cd d:\pcb } board } Returns to PcBoard Suggested PCBSetup Door Security File: Filename Password Sec Login SYS SYS Shell ══════════ ════════════ ═══ ═════ ════ ════ ═════ 1) VERIFY 1 Y N N N ******************************************************************** 10.3 MULTI-NODE OPERATION ──────────────────── The Verify Door performs share-compatible reads/writes with all files. In the event that the files are not network compatible, your configuration for each node must specify a different filename. Usually the best method of doing so is to append a '1', '2' (etc.) to the end of the filename. The files NOT compatible between nodes are listed below. You should make a different config file for each node, such as TCBV1.CNF for node 1, TCBV2.CNF for node 2, and make the appropriate changes in the batch file that loads the door from each node. (See examples below) FILES NOT COMPATIBLE BETWEEN NODES: SYS file (PCBoard.Sys) LOG file (Callers log or text file for The Verify Door log) FOR MULTI-NODE OPERATION: NODE1 batch: cd d:\door } You should put all TVD associated files in a separate directory tcbvd124 d:\door\tcbv1.cnf } Command line to invoke the door using TCBV1.CNF as the configuration file and runs The Verify Door. cd d:\pcb } board } Returns to PcBoard node 1 NODE2 batch: cd d:\door } You should put all TVD associated files in a separate directory tcbvd124 d:\door\tcbv2.cnf } Command line to invoke the door using TCBV2.CNF as the configuration file and runs The Verify Door. cd d:\pcb2 } board2 } Returns to PcBoard node 2 ******************************************************************* 10.4 Exit Codes ────────── When a REGISTERED version of TVD completes execution, it will return one of several possible DOS Errorlevel codes (exit codes) for those sysops who wish to do additional processing depending on what the user does while in TVD. The following is a list of the exit codes returned and the meaning of each: DOS Errorlevel What it means ────────────── ───────────── 0 Successful verify 1 Carrier lost 2 Aborted 3 User pressed only ENTER at password prompt 4 No response from user to prompt 5 Not at new user level 6 Long distance # not dialed 7 Bad # not dialed 8 Illegal dial time 9 Incorrect password 10 Number already verified 11 Maximum redials reached 99 TVD system error. Check ERROR.LOG 11.0 REGISTERING The Verify Door ─────────────────────────── DO NOT REGISTER THIS SOFTWARE IF: Do NOT register this software unless you are satisfied that it will fulfill your verify-by-callback requirements! Do NOT register this software if you have not verified that it runs successfully on the system on which you intend to run it! REGISTER THIS SOFTWARE IF: Register if you want to prevent users from having more than one account on your system. The demo version does NOT check for previously verified phone numbers and will happily call back the same phone number an unlimited number of times! Register if you want to enable the other 'registered version only' features of The Verify Door. Register just to make my day! Receipt of your registration is the same as telling me that you think I did a good job and that my hard work is appreciated. In order to register The Verify Door, complete REGISTER.FRM, (or fill out the form at the end of this document if the form is missing), print it out and send it to the address shown along with a check or money order for $20.00 US. You will be mailed a registration number. After placing this number in your configuration file you will have a full registered version of The Verify Door for this and all future releases as stated above, including any updates compatible with PCBoard v15.0. Why register? You are requested to register The Verify Door after running it for a period of not too much longer than 30 days or so. This door was NOT written in an effort to copy other existing verify doors, but in an effort to write a verify door that would work properly on my own system where others failed for one reason or another and also to make sysoping a little easier. Since that time, hundreds of hours of have gone into enhancing and de-bugging TVD and it has grown into a door which many other PCBoard sysops have found to be both beneficial and useful on their own systems. My only request, then, is that if you find that using TVD on your PCBoard system helps make the part of your life as a sysop easier, then your timely registration is requested. 12.0 TECHNICAL SUPPORT ───────────────── Page Three BBS Node 1: (407) 327-8421 Node 2: (407) 327-4524 PC-Pursuit: FLORL 24 hours / 7 days Node 1: 12/24/96/38.4k baud HST Node 2: 1200/2400 baud mnp Jim Lockhart, Sysop and Author Sysops that request access to Page Three will be granted extended privileges only upon mail registration or by request when TVD registration is received. Since there are many people that call Page Three BBS only once or twice to download The Verify Door it is difficult and often useless to try to keep track. If you are having a problem getting The Verify Door set up for use on your system, feel free to call Page Three and leave a comment to the sysop describing in as much detail as possible the problem you are having. Be sure and include the ERROR CODE(S) of the error(s) in question. (You may find that a file called ERROR.LOG is in the directory in which TCBVDxxx.EXE resides) Special thanks to all the PCBoard sysops that gave their ideas and recommendations to me for future versions of The Verify Door. I hope that I've done a good job and that it helps make running your bbs a little easier! 13.0 The Verify Door REGISTRATION FORM _________________________________ Sysop name: _________________________________________ Address: _________________________________________ City, State, Zip: _________________________________________ Home phone #: _________________ TVD Version : ______v1.24______ Please type (or print carefully) below the name of the bbs to register exactly as you want it to appear on screen. Mixture of capital and small letters is OK. Your registration number is determined using your bbs name and is CASE SENSITIVE. HINT: You might want to stop now and run PCBSETUP to see exactly how your system name is appears there. It may be different than you think! Board to register: (EXACTLY as you want it to appear on screen, case sensitive.) ___________________________________ Phone: ____________ Make your check or M.O. for $20.00 US payable to Jim Lockhart and mail to: Jim Lockhart The Verify Door Registration 317 San Miguel St. Winter Springs, FL 32708 You will receive your registration number within three weeks after I have received your form and payment. If you do not receive a registration number after approximately 3 weeks, please contact Page Three BBS. If you wish, I will call your system after your payment is received and leave you a comment with your registration number. If you would like to have me call your system with your registration number, please open a user account for for me per the following: User Name: Jim Lockhart Password : ____________ <==Please write my password here ----------- Do not write below this line - 'for office use only' ------------- Encrypted BBS name : Registration number: Date notified : ------------------------------------------------------------------------------